GetZoneList
查询app下的zone的信息
请求地址
POST
http://OmsAddress/app/newoms.php/webservice/business/app/get-zone-list?cmd=10010&ip-type=webservicerest&access-token=AccessTokenVal
POST请求参数说明
参数名称 | 数据类型 | 说明 | 是否必填字段 | 备注 |
---|---|---|---|---|
app_id | 整型 | zone所在的业务的id | 是 | |
set_id | 整型 | 游戏区所在的集群的id | 否,未指定时,返回所有set下的zone列表 |
Data参数
使用json格式表示记录相关信息,示例如下:
{
"set_id": 1,
"app_id": 2
}
返回语法
返回参数说明
返回状态码不为200时,表示查询失败,返回数据为错误信息
返回状态码为200,表示查询成功,返回指定set_id,app_id的信息
请求示例
通过 curl 方法发起请求
命令中的参数请参考本页中的“POST请求参数说明”,access-token的获取方法详见:获取access-token
curl -H "Content-type: application/json" -X "POST" -d '{
"set_id": 1,
"app_id": 2
}' 'http://omsaddress/app/newoms.php/webservice/business/app/get-zone-list?cmd=10010&ip-type=webservicerest&access-token=<access-token>'
返回示例
成功返回示例
http请求的Status=200
[
{
"uid": 1,
"set_id": 1,
"app_id": 2,
"zone_id": 3,
"zone_name": "tdr_zone",
"create_date": "2021-06-25 10:38:29",
"zone_tag": "test",
"zone_group": "",
"set_name": "test_set"
},
{
"uid": 3,
"set_id": 1,
"app_id": 2,
"zone_id": 4,
"zone_name": "yyyy",
"create_date": "2021-06-28 10:18:22",
"zone_tag": "",
"zone_group": "",
"set_name": "test_set"
},
{
"uid": 4,
"set_id": 1,
"app_id": 2,
"zone_id": 5,
"zone_name": "aaaa",
"create_date": "2021-06-28 10:18:43",
"zone_tag": "",
"zone_group": "",
"set_name": "test_set"
},
{
"uid": 5,
"set_id": 1,
"app_id": 2,
"zone_id": 6,
"zone_name": "bbbb",
"create_date": "2021-06-28 10:18:53",
"zone_tag": "",
"zone_group": "",
"set_name": "test_set"
},
{
"uid": 6,
"set_id": 1,
"app_id": 2,
"zone_id": 7,
"zone_name": "cccc",
"create_date": "2021-06-28 10:19:01",
"zone_tag": "",
"zone_group": "",
"set_name": "test_set"
}
]
错误返回
http请求的Status!=200
{
"name": "Unauthorized",
"message": "You are requesting with an invalid credential.",
"code": 0,
"status": 401,
"type": "yii\\web UnauthorizedHttpException"
}
{
"app_id": [
"ip(10.29.89.68) not in whitelist to query zones info(cmd:10010) of set_id:126 app_id:2"
]
}